home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / The Director Toolkit v1.0.adf / Executes / AssignIt / docs < prev   
Text File  |  1987-02-25  |  5KB  |  115 lines
  1.  
  2. |c7|t1|f2AssignIt|c3|t0|f1|r1
  3.  
  4. This program is particularly useful to |c7Director|c3 owners who are 
  5. using custom fonts or using the sound module, but may also be useful 
  6. with any other programs having similar problems determining
  7. the name of the directory they are being run from when run from
  8. an icon.|r1
  9.  
  10. Similar to |c7IconX|c3|-, |c7AssignIt|c3 allows you to add several
  11. |c7CLI|c3 commands to be
  12. automatically run from an icon.  It's primary purpose is to make it
  13. easier to do some preliminary |c7ASSIGN|c3 commands before running the
  14. |c7Projector|c3|-, and some cleanup |c7ASSIGN|c3|-s afterwards.  It 
  15. also can be used from the |c7CLI|c3 as well.|r1
  16. |e
  17.  
  18. When using custom fonts or the sound module, someone has to tell the 
  19. system where all the stuff is.|r1  
  20.  
  21. Due to an anomaly in the |c7AmigaDOS Execute()|c3 system 
  22. routine (which the Director makes use of
  23. internally for its EXECUTE command), commands being |c7EXECUTE|c3|-d
  24. will always think they are being run from the root directory of 
  25. |c7DF0:|c3|-, with no way to determine where the 
  26. |c7EXECUTE|c3|-ing film is actually
  27. being run from.  This makes it virtually impossible to assign |c7FONTS:|c3
  28. to the directory you are running your .film from without making some
  29. assumptions as to the name of the disk on which the film is
  30. contained.  This presents some difficulties in producing a film
  31. that can just be dragged to a hard disk and run without adding extra
  32. |c7ASSIGN|c3|-s to the hard disk's startup-sequence.|r1
  33. |e
  34.  
  35. This program is a small (6K) program with icon, that determines it's
  36. own directory, and does an |c7ASSIGN HERE:|c3 to that directory.  It 
  37. will then search the |c7tooltypes|c3 parameters in the icon for a string 
  38. that starts with |c7EXECUTE=|c3.  It will do an |c7Execute()|c3 call to 
  39. run the program(s) (with parameters) specified by these |c7EXECUTE=|c3 
  40. entries (multiple entries are allowed).|r1
  41.  
  42. You can inspect the |c7tooltypes|c3 parameters by clicking on the icon once,
  43. and then selecting |c7"info"|c3 from the |c7WorkBench|c3 menus.|r1
  44. |e
  45. The example does an |c7EXECUTE=ToolKit:projector here:demo.film|c3 to
  46. run a simple
  47. circle drawing film file.  This particular demo simply loads a blank
  48. background file from the current directory using |c7HERE:|c3 to reference
  49. it.  While |c7HERE:|c3 is not required to access picture files in the current
  50. directory, it is simply showing that |c7HERE:|c3 has been assigned and is
  51. working.|r1
  52.  
  53. The reference to the |c7ToolKit|c3 is only necessary because there was no
  54. room on the |c7ToolKit|c3 disk to place an extra copy of the
  55. |c7Projector|c3 into
  56. the |c7AssignIt|c3 directory,
  57. and your boot disk
  58. may not have the |c7Projector|c3 included in the |c7CLI|c3 search path.
  59. If you drag the |c7AssignIt|c3 directory to a hard disk, you can eliminate
  60. the |c7ToolKit:|c3 reference in the |c7tooltypes|c3 here if the
  61. |c7Projector|c3 is in
  62. your |c7C:|c3 directory or somewhere in the |c7CLI|c3 search path.  Otherwise
  63. you can copy the |c7Projector|c3 into the |c7AssignIt|c3 directory,
  64. which also will eliminate the need for this
  65. reference to |c7ToolKit|c3|-.
  66. |e
  67.  
  68. A film can then assume that |c7HERE:|c3 is assigned
  69. to it's current directory, and specify that as the location of the
  70. |c7FONTS:|c3 and the |c7MOD:|c3(for the sound module) if required, with 
  71. |c7Director|c3 commands such as:|r1
  72.  
  73. |+8|c7EXECUTE a,"assign mod: here:options"|c3|r1
  74.  
  75. |+8|c7EXECUTE a,"assign fonts: here:fonts"|c3|r1
  76.  
  77. All other references to file names (picture,sound etc.) within the 
  78. script should probably be done using |c7HERE:|c3 for correct operation.|r1 
  79.  
  80. Upon exit of the program, |c7AssignIt|c3 will un-assign |c7HERE:|c3 so 
  81. the entry does not take up any memory.
  82. |e
  83.  
  84. The icon also has a |c7WINDOW=|c3 command in the tooltypes section of the
  85. icon (check this with the workbench "info" command after clicking
  86. once on the AssignIt icon).  This sets up an initial window which
  87. may be necessary for the programs being run if they output anything
  88. to the |c7CLI|c3 window such as the |c7Projector|c3|-.  Without the
  89. window definition, a Software Error will result.|r1
  90.  
  91. You may decide to re-name a copy of |c7AssignIt|c3 to something 
  92. more suitable for your .film file.|r1
  93.  
  94. |c7AssignIt|c3 will also run from the |c7CLI|c3 simply by typing it's name,
  95. making it easy to run the program simply by typing the "renamed"
  96. name of the |c7AssignIt|c3 command.
  97. |e
  98.  
  99. The |c7Enhanced Blit Utility|c3 is an example of the use of 
  100. |c7AssignIt|c3|-.  The
  101. file |c7EBU|c3 and it's icon is a renamed 
  102. |c7AssignIt|c3|-.  By using the WorkBench
  103. |c7"info"|c3 menu selection on the |c7EBU|c3 icon, you can inspect how 
  104. it was used in another example.
  105. |e
  106.  
  107. Note that |c7AssignIt|c3|-'s use of |c7HERE:|c3 is not 
  108. multi-taskable, that is, if
  109. you try to run two |c7AssignIt|c3 programs 
  110. simultaneously, the |c7HERE:|c3 label
  111. may get changed, as such labels are system-wide.  If this proves to
  112. be a difficulty, an |c7ASSIGN uniquename: HERE:|c3 as the first command,
  113. then using the unique name instead of |c7HERE:|c3 will minimize the problem.
  114.  
  115.